home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / pwrlst37.zip / PWRLIST.DOC < prev    next >
Text File  |  1993-02-27  |  23KB  |  513 lines
  1.  
  2.  
  3.  
  4.                ▄▄▄▄▄▄    ▄▄▄▄▄▄   ▄        ▄  ▄▄▄▄▄▄  ▄────▄
  5.                █    ▀▄  ▄█    █▄  █        █  █       █    ▀▄
  6.                █─────▀  █      █  ▀▄  ┌┐  ▄▀  █────   █───▄─▀
  7.                █        ▀█    █▀   ▀▄┌┘└┐▄▀   █       █   ▀▄
  8.                ▀         ▀▀▀▀▀▀     ▀▀  ▀▀    ▀▀▀▀▀▀  ▀    ▀
  9.  
  10.                         ▄        ▄   ▄▄▄▄▄▄  ▄▄▄▄▄▄▄
  11.                         █        █  █▀    ▀     █
  12.                         █        █  ▀─────▄     █
  13.                         █        █  ▄    ▄█     █
  14.                         ▀▀▀▀▀▀▀  ▀  ▀▀▀▀▀▀      ▀
  15.  
  16.  
  17.                               version  3.7
  18.  
  19.                                    by
  20.  
  21.                               Mike Weaver
  22.  
  23.  
  24.  
  25.  
  26.                                CONTENTS
  27.                                ========
  28.                                                                              
  29.                               Overview
  30.                               Copyright
  31.                               Warranty
  32.                               Distribution
  33.                               Registration
  34.                               List of files in archive
  35.                               Configuration Files
  36.                               Environment Variables
  37.                               Batch File
  38.                               Sysop Keys
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                                  OVERVIEW
  50.                                  --------
  51.  
  52. Power List is a utility for PCBoard 14.x, although it has not been tested
  53. on any other systems it should work fine with any system that can produce
  54. a DOOR.SYS, PCBOARD.SYS, USERINFO.DAT, DORINFOx.DEF, CALLINFO.BBS and a
  55. few others.
  56.  
  57. Power List allows the user to design and download a custom built list of
  58. available files on a particular BBS. Hence the name.  Rather than tying up
  59. your system to download a very large complete file listing the user selects
  60. those files areas that interest him/her and then Power List will do the rest.
  61.  
  62. Using PKZip(tm) Power List will compress all the selected file directories
  63. and then using DSZ(tm) it will allow the user to download the list.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                Copyright
  73.                                ---------
  74.  
  75. POWER LIST,  Copyright (c) 1992 by Mike Weaver,  is being distributed as
  76. Shareware.  Under this concept you may use the  SHAREWARE (unregistered)
  77. version for a  reasonable period of  time for evaluation after which you
  78. must either register your copy or discontinue  usage.
  79.  
  80.  
  81.  
  82.                          DISCLAIMER - WARRANTY
  83.                          ~~~~~~~~~~~~~~~~~~~~~
  84. This product is provided as is without warranty of any kind.  The entire
  85. risk as to the results and performance of the program is assumed by you.
  86. Futhermore, the  author does not warrant, guarantee, or  make any  other
  87. representations regarding the use of,  or the  results of the use of the
  88. program,  and you rely on the  program and  results  solely at  your own
  89. risk.  The author  cannot and will not accept  responsibility for system
  90. damage, loss of profit or any other special, consequential or incidental 
  91. damages  resulting  from  the use of or inability to  use this  product.
  92.  
  93.  
  94.  
  95.                              Distribution
  96.                              ------------
  97.  
  98. This program is being distributed via the SHAREWARE concept and as such,
  99. may be copied freely with the following restrictions:
  100.  
  101.         * The program must be supplied in it's original unmodified
  102.           form, including documentation.
  103.  
  104.         * This program may not be distributed as part of any commercial
  105.           application or service without the express, written consent
  106.           of the author.
  107.  
  108.         * Vendors of Shareware/Public Domain software may not
  109.           distribute this program without the express, written
  110.           consent of the author.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                              Registration
  118.                              ------------
  119.  
  120. This door represents  many hours of  programming and the author deserves
  121. just compensation for his time, efforts and expertise.  If you find this
  122. program to be of some  value and you  continue to use it on your system,
  123. you must return the order form provided along with the registration fee.
  124. Registration entitles you to free upgrades via modem from The NITE-LITE.
  125. Payments should be  made in the  form of a check or money order.  Or you
  126. can register by credit card on The NITE-LITE bbs.
  127.  
  128.                 The NITE-LITE bbs: (615) 458-9099 v.32bis
  129.  
  130. NOTE: After I recieve your registration fee,  your registration number
  131.       will be posted in a private message on The NITE-LITE.
  132.  
  133.         I have not crippled this program in any way, so you can use it
  134.         forever if you like.  However be forewarned that unless you
  135.         register I may not be apt to answer questions as freely.  I
  136.         too however realize the cost of running a BBS so I ask only a
  137.         mere $15 if you like and use the program.  If you do not like
  138.         the program and have an idea that would make it more likeable
  139.         by all means let me know and I will try to implement it.
  140.  
  141.                       List of Files in archive:
  142.                       -------------------------
  143.           Sample.cfg                             Pwrlist.doc
  144.           Pwrlist.exe                            Pwrlist.
  145.           File_id.diz                            History.doc
  146.  
  147. SAMPLE.CFG    This is the door configuration file.  The one included in
  148.               this archive is a sample and will have to be edited to fit
  149.               your system.
  150. PWRLIST.DOC   Three guesses and the first 2 don't count. <Grin>
  151. PWRLIST.EXE   The executable door program itself.  This door is a stand
  152.               alone program that requires no other files such as DoorPatch
  153.               or Brun. I wrote this door using DoorFrame 3.8
  154. PWRLIST.      This is a sample batch file to run the door on PCBoard
  155.               systems.  You may have to edit it depending on where you
  156.               store the door files etc.
  157. FILE_ID.DIZ   This file contains program descriptions for boards that
  158.               implement automatic file description insertion with a
  159.               program such as PCBDescribe(tm).
  160. HISTORY.DOC   A list of corrections or bug fixes or changes in Power List
  161.  
  162.  
  163.  
  164. Example configuration file for|PCBOARD.SYS|
  165. ------------------------------------------
  166.  
  167. C:\PCB\PCBOARD.SYS    <=-  (Full pathname of your PCBOARD.SYS file)
  168. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  169. Mike                  <=-  (The Sysop's first name)
  170. Weaver                <=-  (The Sysop's last name)
  171. 662345922             <=-  (Your registration #)  Use this one till you get one
  172. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  173. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  174.                             line blank!  If line above is 0 this line will be
  175.                             ignored.
  176. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  177. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  178. 60                    <=-  (Number of dir files available)
  179. dos1                  <=-  (From here to the end of the config file is the
  180. dos2                        file names of each of the dir files you want
  181. dos3                        to be accessable by Power List)
  182. dos4
  183. dos5
  184. etc.
  185.  
  186. Example configuration file for|USERS.SYS|
  187. ------------------------------------------
  188.  
  189. C:\PCB\USERS.SYS      <=-  (Full pathname of your USERS.SYS file)
  190. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  191. Mike                  <=-  (The Sysop's first name)
  192. Weaver                <=-  (The Sysop's last name)
  193. 662345922             <=-  (Your registration #)  Use this one till you get one
  194. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  195. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  196.                             line blank!  If line above is 0 this line will be
  197.                             ignored.
  198. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  199. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  200. 60                    <=-  (Number of dir files available)
  201. dos1                  <=-  (From here to the end of the config file is the
  202. dos2                        file names of each of the dir files you want
  203. dos3                        to be accessable by Power List)
  204. dos4
  205. dos5
  206. etc.
  207.  
  208.  
  209. Example configuration file for|DOOR.SYS|
  210. ---------------------------------------
  211.  
  212. C:\BBS\DOOR.SYS       <=-  (Full pathname of your DOOR.SYS file)
  213. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  214. Mike                  <=-  (The Sysop's first name)
  215. Weaver                <=-  (The Sysop's last name)
  216. 662345922             <=-  (Your registration #)  Use this one till you get one
  217. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  218. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  219.                             line blank!  If line above is 0 this line will be
  220.                             ignored.
  221. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  222. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  223. 60                    <=-  (Number of dir files available)
  224. dos1                  <=-  (From here to the end of the config file is the
  225. dos2                        file names of each of the dir files you want
  226. dos3                        to be accessable by Power List)
  227. dos4
  228. dos5
  229. etc.
  230.  
  231.  
  232. Example configuration file for|USERINFO.DAT|
  233. -------------------------------------------
  234.  
  235. C:\BBS\USERINFO.DAT   <=-  (Full pathname of your USERINFO.DAT file)
  236. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  237. Mike                  <=-  (The Sysop's first name)
  238. Weaver                <=-  (The Sysop's last name)
  239. 662345922             <=-  (Your registration #)  Use this one till you get one
  240. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  241. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  242.                             line blank!  If line above is 0 this line will be
  243.                             ignored.
  244. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  245. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  246. 60                    <=-  (Number of dir files available)
  247. dos1                  <=-  (From here to the end of the config file is the
  248. dos2                        file names of each of the dir files you want
  249. dos3                        to be accessable by Power List)
  250. dos4
  251. etc.
  252.  
  253. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  254.  
  255. Example configuration file for|CALLINFO.BBS|
  256. -------------------------------------------
  257.  
  258. C:\BBS\CALLINFO.BBS   <=-  (Full pathname of your CALLINFO.BBS file)
  259. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  260. Mike                  <=-  (The Sysop's first name)
  261. Weaver                <=-  (The Sysop's last name)
  262. 662345922             <=-  (Your registration #)  Use this one till you get one
  263. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  264. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  265.                             line blank!  If line above is 0 this line will be
  266.                             ignored.
  267. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  268. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  269. 60                    <=-  (Number of dir files available)
  270. dos1                  <=-  (From here to the end of the config file is the
  271. dos2                        file names of each of the dir files you want
  272. dos3                        to be accessable by Power List)
  273. dos4
  274. dos5
  275. etc.
  276.  
  277.  
  278. Example configuration file for|DORINFOx.DEF|
  279. -------------------------------------------
  280.  
  281. C:\BBS\DORINFOx.DEF   <=-  (Full pathname of your DORINFOx.DEF file)
  282.                       <=-  (Change this to your BBS name)
  283. The NITE-LITE bbs     <=-  (The Sysop's first name)
  284. Mike                  <=-  (The Sysop's last name)
  285. Weaver                <=-  (Your registration #)  Use this one till you get one
  286. 662345922             <=-  (Location of your file directory menu)
  287. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  288. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  289.                             line blank!  If line above is 0 this line will be
  290.                             ignored.
  291. c:\pcb\menus\dirs     <=-  (Hard drive location of dir files) backslash a must
  292. c:\pcb\gen\           <=-  (Number of dir files available)
  293. 60                    <=-  (From here to the end of the config file is the
  294. dos1                        file names of each of the dir files you want
  295. dos2                        to be accessable by Power List)
  296. dos3
  297. dos4
  298. dos5
  299. etc.
  300.  
  301. Example configuration file for|SFDOORS.DAT|
  302. ------------------------------------------
  303.  
  304. C:\BBS\SFDOORS.DAT    <=-  (Full pathname of your SFDOORS.DAT file)
  305. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  306. Mike                  <=-  (The Sysop's first name)
  307. Weaver                <=-  (The Sysop's last name)
  308. 662345922             <=-  (Your registration #)  Use this one till you get one
  309. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  310. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  311.                             line blank!  If line above is 0 this line will be
  312.                             ignored.
  313. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  314. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  315. 60                    <=-  (Number of dir files available)
  316. dos1                  <=-  (From here to the end of the config file is the
  317. dos2                        file names of each of the dir files you want
  318. dos3                        to be accessable by Power List)
  319. dos4
  320. dos5
  321. etc.
  322.  
  323.  
  324. Example configuration file for|CHAIN.TXT|
  325. ----------------------------------------
  326.  
  327. C:\BBS\CHAIN.TXT      <=-  (Full pathname of your CHAIN.TXT file)
  328. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  329. Mike                  <=-  (The Sysop's first name)
  330. Weaver                <=-  (The Sysop's last name)
  331. 662345922             <=-  (Your registration #)  Use this one till you get one
  332. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  333. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  334.                             line blank!  If line above is 0 this line will be
  335.                             ignored.
  336. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  337. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  338. 60                    <=-  (Number of dir files available)
  339. dos1                  <=-  (From here to the end of the config file is the
  340. dos2                        file names of each of the dir files you want
  341. dos3                        to be accessable by Power List)
  342. dos4
  343. dos5
  344. etc.
  345.  
  346.  
  347. Example configuration file for|TRIBBS.SYS|
  348. ----------------------------------------
  349.  
  350. C:\BBS\TRIBBS.SYS     <=-  (Full pathname of your TRIBBS.SYS file)
  351. The NITE-LITE bbs     <=-  (Change this to your BBS name)
  352. Mike                  <=-  (The Sysop's first name)
  353. Weaver                <=-  (The Sysop's last name)
  354. 662345922             <=-  (Your registration #)  Use this one till you get one
  355. 1                     <=-  (1 = non-standard comport  0 = normal comports)
  356. 2e8,5                 <=-  (Base,Irq  for non-standard port) Don't leave this
  357.                             line blank!  If line above is 0 this line will be
  358.                             ignored.
  359. c:\pcb\menus\dirs     <=-  (Location of your file directory menu)
  360. c:\pcb\gen\           <=-  (Hard drive location of dir files) backslash a must
  361. 60                    <=-  (Number of dir files available)
  362. dos1                  <=-  (From here to the end of the config file is the
  363. dos2                        file names of each of the dir files you want
  364. dos3                        to be accessable by Power List)
  365. dos4
  366. dos5
  367. etc.
  368.  
  369.  
  370. Line 1 ->  Is the location of your BBS info file. The program requires
  371.            the complete path and filename. I recommend using USERS.SYS
  372.            for PCBoard use.
  373. Line 2 ->  The name of your BBS goes here.
  374. Line 3 ->  The SysOp's first name.
  375. Line 4 ->  The SysOp's last name.
  376. Line 5 ->  This is where you put your serial number once you register the
  377.            program.  Until then use any 9 digit number you like but don't
  378.            leave this line out or the door will crash!
  379. Line 6 ->  This line tells DSZ whether or not you are using non-standard
  380.            comports. 0 means you are not and 1 means you are.
  381. Line 7 ->  This is where you define your non-standard port configuration.
  382.            The format is BASE,IRQ.  Example: 2e8,5. If you are not using
  383.            non-standard ports you must still have something on this
  384.            line. I recommend "Disabled" without the quoates.  As with
  385.            all the other lines in the .cfg file this line cannot be left
  386.            out!
  387. Line 8 ->  This is the location of your file directory menu.  The example
  388.            above is from my system, use whatever you use in PCBSetup.
  389.            Or you can create a special directory menu if you like just
  390.            be sure to tell the config file when to find it.
  391. Line 9 ->  This is the hard drive directory path to your individual files
  392.            directories.  In other words the directory where the dir files
  393.            are stored.  !! Important !!  The trailing backslash is a must!
  394. Line 10->  This number represents the total number of dir files on your
  395.            system.  This number needs to match the number of entries in
  396.            the next instruction.
  397. Line 11->  From here to the end of the .cfg file is where you tell the
  398.            program the name of each of your systems dir files.  Using this
  399.            method seemed more versatile to me.  The unregistered version
  400.            is not crippled and will handle as many directories as you
  401.            need to.  However if you use the door Please Register.
  402.  
  403.  
  404.                          Environment Variables
  405.                          ---------------------
  406.  
  407. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  408. variables. Non-PCBoard systems may also use these variables by including
  409. the following in either your BBS batch or AUTOEXEC.BAT
  410.  
  411.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  412.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  413.  
  414. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  415. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  416. .CNF file for multi-node operation!
  417.  
  418. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  419. command line.  For example:
  420.  
  421.      PWRLIST PWRLIST.CNF /5
  422.  
  423. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  424.  
  425.      PWRLIST PWRLIST.CNF /%IRQ%
  426.  
  427. This tells the program to use IRQ 5 instead of the standard IRQ.
  428.  
  429.  
  430. !!!! I have only run and tested this door with PCBoard 14.5a and I cannot !!!!
  431. !!!! attest to its ability to run on any other systems. Consider yourself !!!!
  432. !!!! warned in advance.                                                   !!!!
  433.  
  434.  
  435.                           Example Batch File
  436.                          -------------------
  437.  
  438. A sample batch file is included and is similer to the following:
  439.  
  440.    ECHO OFF
  441.    CD\DOORS\PWRLIST         <=- Switch to the door's Directory.
  442.    PWRLIST PWRLIST.CNF      <=- Execute the door program and pass the
  443.                                 configuration filename to the program.
  444.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  445.    BOARD                    <=- Restart BBS.
  446.  
  447. This Door is multi-node  compatible so you may run more than 1 node from
  448. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  449. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  450. variables, (q.v.)
  451.  
  452.  
  453.                               Sysop Keys
  454.                               ----------
  455. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  456.          written to DOOR.SYS and USERS.SYS
  457. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  458.          and/or written to DOOR.SYS and USERS.SYS
  459. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  460. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  461.          and/or written to DOOR.SYS and USERS.SYS
  462. F8    -  Returns the caller involuntarily to the BBS.
  463. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  464.          and/or written to DOOR.SYS and USERS.SYS
  465. F10   -  Activates SysOp CHAT mode within the DOOR.
  466. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  467. UP    -  Give the caller extra time while in the DOOR.  
  468. DN    -  Subtract time from the caller while in the DOOR. 
  469. HOME  -  HELP key for Status Line options.
  470. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  471. ALT-X -  PCBoard will exit after current caller logs off. Value is
  472.          passed to PCBoard. Not available on non-PCBoard systems.
  473.  
  474.  
  475. One last thing I am terrible at writing so if these docs seem hard to read
  476. or use it is probably because they are. <GRIN>
  477.  
  478.  
  479.                                CREDITS
  480.                                -------
  481.  
  482.         I want to thank Todd Stephens for his unending help when my
  483.         needs overcome my ability.
  484.  
  485.         I also want to thank Ted Freeman for his great program Door-
  486.         Frame, as well as for his never ending help as I tried to
  487.         convert Power List over to use DoorFrame and in turn be much
  488.         more versatile.
  489.  
  490.  
  491.                      OK I'm finished, send the millions to:
  492.  
  493.                                 Mike Weaver
  494.                                 % The NITE-LITE bbs
  495.                                 Rt. 1 Box 231b
  496.                                 159 Moatsewell Rd.
  497.                                 Philadelphia, Tn.
  498.                                                37846
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.